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DISCLAIMER* NOS/VE is Intended for use as described in this 

document. CONTROL DATA CORPORATION cannot be responsible 
for the correct operation of features or parameters not 
descr I bed. 
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1) The NOS/VE Cycle IT system consists of the 

operating system and product set features outlined 

In the NQS/VE l.§ Software Availability Bulletin (SAB). 

The NOS/VE Cycle 1? system must be Instilled using 

the release materials* <$ee the NOS/VE 1*0 SA8* pages 11 

and 12* for the list of the release materials*) 

Has V2.2 Level 596 Operating System and Level 587 

for the Common Products must be Installed on the 

computer before installing NOS/VE Cycle 17 to complete 

the dual state system configuration* 

Z) It is necessary to understand this document* the NOS/VE 
1.0 SAB* the NOS/VE Installation and Upgrade Hanual 
(60463913}* and the NOS 2*2 Level 596 Operating System 
and Level 587 for the Common Products and related 
documents before Installing NOS/VE Cycle 17. 

3) After installing NOS V2*2 Level 596 Operating System 
and Level 587 for the Common Products system and the 
NOS/VE Cycle 17 system, the NOS and NOS/VE 

systems may be deadstarted and placed into operation* 

4) PSR numbers are Included iH th some of the Items in this 
document* These PSRs are outstanding as of the date of 
the release* 
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A complete description of Operating System and Product Set 
features may be found in the NOS/VE 1*0 Software 
Availability Bulletin* Please refer to that document for 
NOS/VE Cycle 17 system feature infomation* 

All references in the NOS/VE 1*0 SAB to the CYBER 170-835 
and CYBER 170-835 should foe updated to Include the CYBER 
170-815. CYBER 170-825. &r\d CYBER 170-845* All references 
in the NOS/VE 1.0 SAi to NOS 2*1 Level 588 should he 

modified to NOS 2*2 Operating System Level 596 end Coupon 
Product Level 587* 
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1) PASSON and XRHF both run out of the SYSTEHX account* Because 
of this* the password must be set to SYSTEHX and the resource 

validations must be set to their maximum* 
PSR # NV00002 

2) The *UN«* parameter on the *S'£?V£* command must have its 
resource validations set to the maximum* failure to do 
this can cause the deadstart Job to fail with f PRU LIHIT f 
or «SRU LIMIT*. 



PSR # NV0Q002 
3*1*2 J&&£££-Ifi5i*ll*ii.flQ 



1) There Is a timing problem/data sensitive bug that may 
occassional ly cause the RESTORE.PERKANENT.FILE command to 
abort* If this occurs* the operator should restart RESTORE 
with the falling reel. If the problem does not re-occur* 
only one file is lost. If the problem still occurs* restart 
RESTORE again but with the reel that follows the failing 
reel* In the second case* all files on the tape following 
the point where the failure occurred are lost* 

2) Automated validation performed during an Installation 
Deadstart creates a SFAHILY. USERS file for the NVE family. 

If you subsequently reload permanent files to family NVE from a 
8ACPF file* catalogs which were not defined in the automated 
validation cannot be accessed* Likewise* any catalog information 
which has not been updated in the automated validation file is 
incorrect for the catalogs restored using BACPF* The recommended 
sequence of events In which an Installation Oeadstart can be 
performed* and the family NVE permanent files restored from a 
previous level is as follows* 

1* 8ACPF all NVE catalogs and files (except 

uuu.SFAMILY.USERS) to tape < uuu is the FAHILY.USER 
Administrator) • 

2* BACPF the file uuu.SFAHILY.USERS. 

This is 4one by bracketing the commands associated with 
the backup with TASK* TASKENO commands* The ring number 
Is established by using the RING parameter of the TASK 
command. For example* 
TASK RIM6*3 

COPY.FILE lnput*aipha output a omega 
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TASKEND 

causes the COPY_FILE command to execute In ring 3* 

HOTEJ 

The task command can be specified only In an 
interactive job or in a batch job running under 
SSYSTEH. 

3. Par form an Install at ion Deadstart of NOS/VE* but enter the 
command DETF VALIOATE/OFAMILY/OMVE prior to entering the 
NEXTDSTAPE response to the request for the first product 
tape* This command will disable automated validation* 

4. Restore the $FAMILY_USERS file that was backed up In step 2* 
ilf you failed to disable validation prior to this step* you 
must login as the NVE family user administrator* and change 
the name of the SFAHTLY.USERS file using Change_Catalog_Entry. ) 

5* Restore the remaining NVE family files which were backed up 

in step 1. 
6« Execute the Create.Fanl 1 y command from the operator console 

PSR NV000T9 

3) The procedure Veri f y_Instal I ed.Sof tware which is documented in 
the N03/VE Installation and Upgrade manual (Publication number 
60463913 A) is not available at this time. 

4) The NOS User Name creation described in the NQS/VE Installation 
and Upgrade Manual implies that the default MODVAL OS value is 
adequate. DS*5 is the appropriate value, 

5) Multiple NQS/VE upgrn^es using the CREATE_JQB_TEMPLATE command 
result in a large number of files being created on the deadstart 
disk. Each successful execution of tha CREAT£_JG8_TEMPLATE command 
creates a directory file and several uniquely named segment files. 
The directory file name is specified by the TEMPLATE.MAHE 
parameter* and contains the name of every segment file which 
constitutes the job template. Whenever a job template is no longer 
being used* the OELETE.JQB.TEMPLATE command should be used to 
remove the directory file from the deadstart disk. Segment files 
are removed by this command whenever the directory file Is removed. 
The console entry for this command is* 

K.DELETE/OMQB/OTEMPUTE TH*name 

6) Online manuals are released on a NOS/VE Backup_Permanent_FI les tape 
at this release. This is an interim process that will be 
replaced by a process being generated by Publications and 
Integration. To installed the online manuals* you must 

reload the files on this tape into the SSYSTEH. MANUALS 
subcatalogs of the SSYSTEH family. Create the following 
HOS/VE job to accomplished this task: 

JOB 

request.magnetlc.tape file 3 backup type«mt9$1600 rlng*no evsn»nve007 

WHEN any.f aul t DO 
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displ ay_value osvlstatus output=$response 

r«quest.oper«tor.action message** RESTORE FAILED - CHECK TAPE 1 
logout 

mEmm 

RESTORE.PERMANENT.FILES 

restore_a! l.f i les btckup.fi le*backup 

QUIT 

JOBEND 

The above job may be created as a NOS or HOS/VE text file* This 
text file is then accessed from the operator console* using the 
ATTACH.FILE or GET.FILE command* and the INCLUDEJFXLE Copland is 
executed to submit this job as a SSYSTEH f am I i y batch job. 

71 Upgrade installation specifying LQADFILES (through 

SET.SYSTEM.ATTRI8UTES) but not milTD causes the deadstart 
version of OCU rather than the standard version of 

OCU to be generated. The $HI6H cycle must be DELF'd 
after th® system Is up* 

8) The operating system requires assistance at the console for 
remote installation and remote maintenance. The installation 

and maintenance procedures are being modified to reduce the 
need for assistance at the console but until Remote Deadstart 
is available* this need will not be totally eliminated* 

9) Great care should be taken using the DELETE.USER subcommand 
of the ADMINXSTER.USER utility. If more than 20 users 
are deleted since Installation of the system* there is a 
good chance ALL USERS WILL BE LOST. 
?$%s NY00896> NVQE061* MV0EO62 

.U2-(iQ2I>£E.Exfi£Utia££ 

1) HOS/VE will not support lore than 10 tasks 
concurrently defined per job* The system 4oes not 
enforce this limit* users must be careful not to 
exceed this limit or they may cause the system to fail* 

2) To successfully terminate a job that has an action message 
posted to assign a tape* the sequence must be as 

fol iOMSS 

K.ASSIGN.DEVICE AI«nnnn STOP 
K.TER!HNAT£_JQB ... 

Failure to assign the device prior to terminating the 

job tiiii cause the job to hang. 
PSR NV0E337 

- COMPANY PRIVATE - 



7 

SOFTWARE RELEASE BULLETIN 

84/02/10 
NQS/Ve (CYCLE 17) 

1) Restarting Up IRHF and IFEXC on the 180 Side 

IRHF should automatically restart if it aborts. There Is 
a constant check to see if it has aborted* To bring up 
IRHF manually* the operator lust first bring down IRHF* then 
bring It up again* The sue holds true for PASSON. 

To bring down IRHF* type in at the 180 NOS/VE operator's 
consoles 

K.DEACTIVAT£_$YSTEH_TASKS TASK_NAH£S*RHINPUT 
K.DEACTIVATE.SYSTEH.TASKS TASK.NANES-RHOUTPUT 

Then to bring IRHF back up* type in at the 180 NQS/VE 
operator's consoles 

K.ACTIVATE.SYSTEH.TASKS TA$K_NAMES»RHXNPUT 
K,ACTIVATE_SYSTE«_TASKS TA$K_NAHE$*RHOUTPUT 

To bring down IFEXC* type in at the 180 HOS/VE operator *s 
consoles 

K«DEACTIVATE.SYSTEN.TASKS TASK.NAHES-IFEXEC 

Then to bring IFEXC back up* type in at the 180 HOS/VE 
operator's- consoles 

K.ACTIVATE.SYSTEH.TASKS TA$KJ*AME«IFEXEC 
PSR NV-30032 

2) Restarting IRHF and PASSON on the 170 Side 

To make provisions for restarting IRHF and PASSOH* a site 
analyst or an operator should create two procedures and save 
each one on an Indirect permanent file that is located under 
user index 3777778. 

Procedure 1« The file name should be NSSXRHF and should look 
I ike this* 

♦PRGC*N$$XRHF. 

CQHHQN*$YSTEf*« 

GTR#SYSTEN*MVELIB.U.ULI8/NVELIB 

UHLOAD*SYSTEH. 

LIBRARY*NVELIB. 

RUN JOBS (IRHF) 

Procedure 2* The file name should be NSSPASS and should look 
I ike thlsi 
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.PROCjMSSPASS. 

COHHOH.SYSTE*. 

GTP.*SYSTEHjNVELX&*U.ULIB/NVELX8 

LIBRARYjNVELXB. 

RUNJQBS(PASSON) 

Once these are in user Index 3777778/ IRHF is restarted fey 
simply typing the foil cuing In at the 170 operator's console: 

M3SIPHF. 
PASSQN Is restarted fey typing In at the 170 operator's console* 

HSSPASS. 

PSR NV00016, 

3) The HOS application (VEIAF) that connects NOS/VE 
jobs to NAM will sometimes produce the flashing 

console message: 

"PASSflN A8N0RHAL 18 M 

This message means PASSON Is discarding an unsolicited 
message generated between VEIAF and the first read 
request from NOS/VE* 

This should he Ignored* Clear the message with *GQ*jsn« > 



1) The IHITIALIZE_DEADSTART_DEVXCE system-core cowhand 
and the INITIALIZEJHS.VOLUNE Logical Configuration 
Utility subcommand do not warn the operator that the 
volume has been previously initialized* This is of 
particular concern in IN17X ALIZE_M$_VGLUME because the 
operator may misspell the eiement.name of the device 
and inadvertently destroy permanent files* 

Z) If the physical configuration consists of one channel* 
one mass storage controller* and one mass storage 
unit* one can describe this initially using 
system-core commands. However* this configuration 
needs to be redescribed using Physical Configuration 
Utility and Logical Configuration Utility subcommands 
in order to get through an installation deadstart* 

3) For optimal system performance all NOS/VE disk units 
should be defined during the install deadstart* This 
is important so that all of the logical configuration 
Is available for allocating product set files* 
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4) 



5) 



7) 



During recovery when operator intervention has bean 
specified* the logical configuration utility CLCU) is 
invoked both before and after the configuration 
transition* The first invocation allocs the operator 
to change which elements in the physical configuration 
are logically configured* The second invocation allows 
the operator to Inl t lal Ize and &d4 volumes to the system set* 
This is useful if the first invocation of the LCU happens 
to add one or more volumes to the logical configuration* 

The ability to Invoke the LCU during a continuation deadstart 
as described in the previous bullet has been added* 

The physical configuration utility subcommand* 

INSTALL. PHYSICAL^CONFIGURATIGM has a new parameter* 

PHYSICAL.^ CONFIGURATION* This parameter specifies 

the name of a local file that will receive Information 

about the physical configuration being debugged* Use 

of this parameter will cause the configuration to 

NOT be installed* The file produced by this command 

can be used as Input to the INSTALL_LOGICAi_CONFIGURATIGN 

subcommand of the logical configuration utility* 

The abbreviation for PHYSICAIJCONFIGURATION Is PC. 

The logical configuration utility subcommand* 
INSTALL.U)GICAL.CtlNFXGURATION has a new parameter* 
PHYSICAL.CONFIGURATIQN* This parameter specifies 
the name of a local fife that will provide information 
about the physical configuration being debugged* Use 
of this parameter will cause the configuration to 
MOT ba installed. The abbreviation for 
PHYSICAL.CQNFIGURATION is PC* 



l*2.&fiXi££-H&Qai2fifl3Q£Z&£fifiX£j:X 



1) If any disk volume being used fey NGS/VE becomes full. 
the fol lowing message will periodically Bppe^r on the 
md screens 

AAAAAA - volume out of space 
(AAA AAA is the vsn of the volume) 

Any task that is requesting space on a full volume 
Mill hang waiting for space* Some space may be 
obtained by asking users (If they are able) to delete 
permanent files and detach local files* If the disk 
full condition persists* the NGS/VE system should be 
taken down and brought back up* This action will 
release most of the temporary file space that was In 
use* If the disk full was caused by permanent files* 
then the disk will be nearly full after the recovery* 
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and some action — such as backing up permanent files 
and deleting some files — oust be taken immediately* 

It is possible that a disk full situation will occur 
that cannot be recovered* This will have happened If 
the "volume out of space** message appears during a 
deads tart before the system is up* In this case 
case permanent file volunes must be in I tlati zed 
and reloaded from a previous backup dump* 

Z) If a continuation deadstart falls after disk full with 
a 180 CPU monitor fault* It Is possible that the failure 
Is due to unp rinted files in the output queue* one or 
more of which are no longer printable* The failure is 
a job mode software failure and does not leave the HCR 
set In monitor mode* The message indicating this 
failure is **H% - NONITOR FAULT". 

Corrective action? 

On the next attempt at a continuation deadstart* enter 
the foil owing command when the system asks for 
operator supplied core commands* 

SET_SY$TEH_ATTRI8UTE HALTRIMG 

This command will allow deadstart to complete* If* at 
this time* you find that task RHOUTPUT has terminated 
(by looking at the system job log by doing a OISSD* and 
files exist in the job output queue (DI$PLAY_CATALQ<3 
$SYSTEM.$JOB.OUTPUT.OUEUE) you can be reasonably sure 
that you have encountered this problem* 

Delete the contents of the job output queue (DELETE 
CATALOG.CONTENTS $SYSTEM.$J08..QuTPUT_QU£U£ )• terminate 
MOS/VE* and 6o another continuation deadstart* 

3) When recovering without a memory image* the EOI for a 
file is set to the highest ai iocat ion-unit which has 
been initialized on the device* This is probably not 
what the actual end-of-I reformat ion (EOI) shows in the 
memory image. The file's owner is not informed that a 
different EOI has been chosen* This means that the user 
cannot use BAH to read the file* The file needs to be 
recreated. 
PSR NV0E524 



2*k.-Eil2Si£al.-i£Q-IIllfigl 



1) Tape support Is limited to and intended for use only by 
the permanent file backup and restore utility* Use of 
tape I/O for any other purpose may produce undefined 
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results* 

2) When preparing to mount a taps to be read by tifj$/VE# the heads on 
the drive should first be cleaned. This is recommended before 
each tape mount dye to the currently incomplete implementation of 
error recovery* 



2a.Z.Xa£££.afititt& 



1) When using X25 to access NOS/VE* a terminal may 

Intermittently hang allowing no Input or output* TIP 
commands break (such as escape-CH) out of this problem* 
This is a €€P problem that has been PSRd and corrected 
in CCP* 
PSR CC5A230 
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1) A coamand that depends on the "path naie" for a file 
is aff acted if the file has been explicitly attached 
(attach.f I le» create.fife commands)* 

The "path name** that such a command trill encounter Is 

the "local path name* rather than the path specified 
when the coram and was called, for example* 

ATTACH.FILE $U5£R*X LFN'Y 
REPLACE.FILE $OSE««X 

Kill result in a file called Y feeing referenced In 
real state rather than X* Users should not nix 
implicit and explicit attaching of a file* 

P5R NVOD753 

2) The $PR06RAN function does not return the open 
position designator for the LOAO.NAP file* 

PSR NV0D48 3 

3) The SET.SENSE.SWITCH (SETS5) command will not accept a 
"user supplied job name** but will only work when given 
a "system supplied job name*** 

PSP NV0D871* PSR HV0D888 

4) The constants $r1IN_INTEGER and $HAX_INTEG£R have 
values of -(2**48-1) and 2**48-1* respectively* 
rather than -< 2**63) and 2**63-1* 

PSR NV0D609 

5) A new di sp I ay.opti on has been added to the d ispl ay_cataiog 
and display_eatafog_entry commands* For the former command 
this display option is called CONTENTCS) or C5 and for 

the latter command it is called CYCLE(S) or C* Also* a 
parameter called DEPTH has been added (following the output) 
parameter) to both commands that works in conjunction with 
the added display options. These options show the amount of 
space occupied by catalogs* flies* and cycles* The depth 
paramster determines the level of detail that is displayed* 

OEPTH-1 gives a 1 line summary of the catalog (or file)* 
0EPTH*2 (the defait) gives a breakdown of files and subcatalogs 
contained directly in a catalog (or the cycles of a file)* 
A DEPTH greater than Z Is only applicable to catalogs and 
specifies a further breakdown of the catalogs and files 
contained within the subcatalogs of the catalog* To get 
complete information about all subcatalogs* flies and cycles 
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contained in a catalog* specify DEPTH«ALl» These c nges 

did not make It Into the manuals* 

This command displays Information about the parameters for 
a command* The information Includes the names of the 
parameters* their types (including ail owed keyword values) and 
their default values ior an Indication that the parameter is 
required)* 

This command Is not intended to foe a replacement for 
information in on-line manuals* but rather a "memory jogger** 
for any command. It Mill work for any contnd that could be 
called at the point where this cowhand Is called (including 
system supplied commands* SCL procedures* user programs »n6 
utility subcommands)* 

This command can be used to obtain information about the 
parameters for any command that uses SCL services to parse its 

parameters* 

dl spl ay_coinPiand_par ameters command *<coaaiand> 
£output=<f i le referenced 
Cstatus-<status varlab!e>1 

command * cs This parameter specifies the command for which 
information about parameters is sought* 

output « os This parameter specifies the file to which the 
parameter information Is written* Omission wilt cause 

SOUTPUT to be used* 

status? This Is the standard status parameter* 

This function is used to determine where the processor for 
the requesting command was found* The source (file or 
catalog) of the command is returned as a string* 

By Its nature* this function isn't particularly useful when 
used in the expression for a parameter to a command* since* in 
that case* it ai II return the source of that command* 
Therefore* this function is normally ussd in an assignment 

statement* 
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<$conmand.source> JJ* $€0MHAND_SQURC£ t<i> <>>! 

Examples **The following proc resides on an** 

"object library in some catalog** 

PROC sanol a.coaswand 
os - $ command. source 
cat * $path?$f nasieCcs )* catalog) 
execute. t ask $f nana C cat//* • samp I e.pr ogr a?a ) 

PROCEND 

a*Lt2*2-i£&E¥IQUS-SIaIUS 

This function is used to obtain the coaptation status of 
the previous command* 

<$prevlous_status> **» $PREVIOUS.STATUS £<«> <)>! 

Example: col I act. text displ ay.status 

PROC display .status* diss < 

status: status * $pre vl ous.status) 
di sp I ay.va lua Svai ue< status ) 
PR0CENQ display. stttus 

craate.var i abl e s kind* status 

cr e ate. v ar I able x status's 

dlspl a /.status 

NORMAL STATUS 

er a ate. var i ab I e x status's 

displ ay.status 

— ERROR— X Is already declared ds a variable* 

This function is used to quote a string* 

<$quote> s:= IQUOTE <C> <string expr> <)> 

Examples s * '<ABC >l 0EF* 
q * $quote(s) 

di spl ay.val ue s 

ABC'DEF 

displ ay.val ue q 

•ABC^DEF* 

This function is used to search a string for any one of a 
set of characters and return the index in the string of the 
found character. If no character fron the set appears In the 
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string* zero is returned. 

<$scan_any> *»■ $SCAN_ANY <<> <char set> <#3sp> 

<string expr> <)> 

<char $&t> ssa <string &%?r> 

Example* digits » »0123456789 f 
s « f TE«f>_32* 
dispi ay_value $sctn.*ny C d i gi ts* s) 

6 



This function is used to search a string for any character 
that is not In a set of characters *n6 return the index in the 
string of the found character. If only characters from the 
set appear in the string* zero is returned. 

<$scan_notany> ** = $SCAN_NOTANY <C> <char set> <*lsp> 

<string expr> <)> 

<char set> ** = <string &xpr> 

Hxa^ples digits « '0123456789* 
s - •TEHP_32 I 
displ ay_va!ue $sc flfi.no t any tdi gi ts* s) 

1 



This function is used to search a string for another 
string* ceiled the pattern* and return the index of the first 
character of the pattern in the string. If the pattern is the 
nui) string* one is returned. If the pattern is not found in 
the string* zero is returned. 

<$scan_strin3> :*» $5CAN_STRING <<> <pattern> <*Jsp> 

<string eyipr> <)> 

<oattern> n= <string expr> 

Examples s * l 123_abc_9« 
P * « abc» 
d i sp I ay_v a I ue $scan_str ingtp* s) 
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This function is used to change characters in a string 
according to a translation table* The translation table is a 
string of Z56 characters $#hich is utilized according to the 
following algorithm* 

result * * • 

for i * 1 to $str I en( string) do 
j * $ord($substr (string* II) 

result * result // Ssufestrf tab le* j+1) 

f oreod 

Two standard translation tables are provided* Use of 
LOWER.TO.UPPER CLTU) produces a string with all lower case 
letters translated to their upper case counterparts* Use of 
yPPER.TO.LGWER (UTL) produces a string with all upper case 
letters translated to their lower case counterparts* 

<Stranslate> ::« ^TRANSLATE <C> translation table> <f\sp> 

<string expr> <)> 

translation tabfe> *** <strlng expr> 

\ 10WER_T0_UPP£R I LTU 
! UPPERjra.LOUER \ UTL 

Examples displ ay.value $tr ansl ate(lower_to_upper» , 123_abc l ) 
123..ABC 

This function is used to remove trailing space characters 
from a string* 

<$triro> ss» $TRIM <(> <string axpr> <)> 

Examples s * 'STRING * 

di spl ay_ value , < f //s// , >' 

<STRING > 

di spl ay. value »<* //$tr I m( s)// •>• 

<STRIHG> 

<push commands) s?~ PU$H_COHMANDS 

The purpose of this statement is to cause the source (file 
or catalog) of the Issuing command to be pushed onto the top 
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of the "dynamic command 1 1 st**» The entries' in the dynamic 
cosunand list are searched after the commands belonging to any 
active utilities and before the command fist entries 
manipulated by the SET.COHHAND.LIST command* The effect of 
this statement Is removed (popped) when the issuing command 
terminates* 

1) The DISPLAY.CATALOG and DISPLAY.CATALOG.ENTRY 

commands* when used on a catalog or file owned by 
another user* should only provide Information for 
catalogs and/or files that the requesting user Is 
permitted to access* This restriction is not 
enforced* The information erroneously provided* 
however* does not include passwords and only contains 
log entries and permit entries that apply to the 
requesting user* 

NY0E251 

HV0B133 

2) Great care should be taken using the DELETE.USER subcommand 
of the ADHINISTERJJSER utility* If more than 20 users 
are deleted since installation of the system* there is a 
good chance ALL USERS MILL BE LOST* 
PSRs NV0D996* NV0EO61* NV0E062 

1) Whan the MOS/170 IRHF Is started via a 013 job (for 
debugging IRHF)* it does not transmit queue files to 
NOS/VE* RUNJOBS is unable to acquire the oueue file 
from NOS/170. 

PSR NV0E292 

A method to work around the problem is to start IRHF with 
an unused "subsystem"* An example would foe to create the 
following PROC within the SYSTEMX catalog: 

•?ROC*"subsystem*IRHF 

C0MM0N*$Y$TEM. 

GTR#SYSTEH*NVELXB»U.ULXB/NVELIB 

ONLOAD* SYSTEH* 

RONJOBS(IRHF) 

REVERT. 
The following command could then be given to DSD* 
"sub system" IRHF 

2) When a bad LOGIN command is present in a batch job* 
the job disappears and printout with the error is 
received by the user to report the problem* This 
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occurs when sending a job from NOS to NOS/VE vis 

ROUTE* xx*DC»LP*FC*RH. 
NVOEVtt 

3) Change Information is not transmitted fro® NOS/VE 

side to the NOS side* 
PSR NV00019 

4) Changing passwords on NOS and NOS/VE* 

In NOS 2*2* there ire two passwords for each user* 
One is the HOS interactive job password and the 
other is the NOS hatch joh password* The NOS 
interactive job password is used while working on 
a terminal. It is also used for NOS/VE login 
processing - when logging into NQS/VE on an 
interactive terminal* there is no check tads of the 
NOS/VE password for validation purposes* Just the NOS 
interactive job password* Changing your NOS/VE 
will affect only your NOS batch password* Your 
NOS/VE password must match your HOS batch password 
otherwise Reaote Host will not work since it submits 
batch jobs to NOS* 

Mote J When using the SET J.INK.ATTRIBUTES command* 
the NOS/VE password specified must patch the NOS 
batch job password* 

Note : The selection of passwords for NOS and NOS/VE 
must conform to the definition as given In the NOS 
Reference Manual for the NOS password and the NOS/VE 
Command Interface Reference Manual for the NOS/VE 
password. You have to take the common parts of both 
definitions to mnk® a password that works for both 
NOS and NOS/VE. 

To change your NOS/VE password* enter the SET_PASS*IGRD 
coiwand on the 180' side * 

SetpM oldpw newpw 

where oldpw is your current NOS/VE password and 
newpw is the new password* 

To change your NOS batch job password* you will 
have to submit a NOS batch job* Login to the 
170 side and create a file to submit this job* 
The file should contain the following * 

JQBCARD. 

USER < us er nam* user pw ) 

CHARGE**. 

P ASS WORC user pw« newpw) 
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END 

where user nam is your usernaaie* userpw is your 
current NOS batch password* and ne%*pw Is your 
new NOS batch password. Your original HQ$ batch 
password is set to your original NOS interactive 
job passwords. All of the above commands in the 
file created must he typed in capital letters* 

To submit this job* type in s 

subni tj I fn*b. 

where 1 f n is the file you created. 

In order to change your NOS interactive job 
password* type in on the 170 side i 

passwor* ol dpw*newpw. 

where oldpw is your current NOS interactive 
password and newpw Is your new Interactive 
job password. 

1) Loading files into multiple rings nay cause improper 
ring attributes to be assigned. 

PSR NV0C789 

2) The file position specifier is ignored when mentioned 
on SETPA. For example* specifying SETPA DEBUGJ3UTPUT; 
$LIST.$£0I will cause debug to overwrite the SLIST 
file from Its 801 position <not EOI as expected). 

PSR NVEA036 



&*l-£J22£i£al-IZ£LU.aa&l 



1) Tape support is limited to and intended for use only 
by the permanent file backup and restore utility. Use 
of tape I/O for any other purpose way produce 
undefined results* 

2) When preparing to mount a tape to be read by NOS/VE* the heads on 
the drive should first be cleaned. This is recommended before 
each tape mount due to the currently Incomplete implejnentet Ion of 
error recovery. 
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1) The $£T_yORKING_€ATALOG <SETUC) command has no effect 
upon files whose names are created within 
applications* For example* 

SETWC ajl 
execute.task 

task generates file name a 

The path name of the file Is not .ajl.aj It Is 
floeal.a* Only actual parameters of a command are 
subject to SETVC direction. 
PSR NVEA027 

2) The preset. value file attribute is not supported, 

PSR NV0B204 

3) File attribute HIN.RECORD.J.ENGTH Is not set properly for 
record.type F flies. HIMJtECQRD.LENGTH should be set to 
HAX.RECQRD.LENGTH if it is allowed to default* but it Is 
currently defaulting to 0. This affects SGRT/HERGE when 
the sort k&y is omitted and the default Is taken* 

PSR NV0D398- 

4) If more than 100 instances of OPEN exist concurrently 
within a single task* an ame$loeai_f i le_l Jmi t message 
Is issued. The passage indicates erroneously that 
162025 local files Is the limit which was exceeded* 
The message should say that only 100 instances of open 
may exist concurrently in a task. 

PSR HV0D836 
P5R NV0D632 

5) Skipping forward/backward by records and partitions 

does not always report the encounter with boundary conditions 
with the correct exception condition* 

PSR NVCE044 
PSR NV0D424 

6) If a PAP returns abnormal status to AHPSOPEH during an 
OPEN (new), the file name Is still registered within 
the job and implicitly created permanent files nre not 
purged. Recommend explicitly purging the permanent file* 

PSR NV0E15G 

7) CORY. FILE does not work on index.sequent ial files when 
executed from with a task • 

PSR NV0E988 

8) File attributes that can be changed cannot be 
reassigned a NIL value* 
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9) DETACH.FILE returns FATAL abnormal status when a file 
Is not known and causes a batch job to terminate* Use 
of the STATUS parameter to Ignore the error Is 
recommended* 

PSR NV0D618 

10) The SET JFILE. ATTRIBUTE comnand for an existing file 
accepts the specification of a preserved attribute 

even If It conflicts with the present one* No error will 
be seen and the preserved attribute nil I not foe changed* 

PSR NV0C839 

PSR NV00617 

PSR MV0OP49 

PSR NV0D536 

PSR NVEA036 

115 When processing a COBOL READ REVERSE statement BAH 

fails to set the file position to BOX and as a result the 
COBOL statement will loop Indefinitely* 
PSR NV0E044 

12) COPY.FILE does not detect a copy to itself via circular 
file connections* 
PSR NV0E286 

13} AmpSput.partial* *ith term. option ■ ameStermi nate* 

at f I le_posl tion B0I# gives f unrecovered write error 1 
on a new file* Recommend using amp$put_par tl al » with 

term.option * amc$ start* 
PSR NV0D666 

14) Files implicitly attached are not implicitly detached. 
PSR NV0E322 



ixZ-Laadsc 
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1) If a task adds a library to the job's object library 
list dynamic loads within that task will be unable to 
satisfy externals from the newly added library* This 
especially affects the usability of commands packaged 
in the job monitor task because libraries added to the 
object library list by the system prolog cannot be used 
to satisfy externals of these commands* 

PSR NV0E175 

2) The default for the program attribute LGA0_RAP_0PTI0N 
Is set to NONE* This means a load map will 

not be generated by EXECUTE.TASK unless the LOAD.MAPJ3PTX0N 
parameter has been previously specified by a S£T_PRGGRAH_ 
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ATTRIBUTE command or explicitly specified on the E CUTE.TASK 

command. 

3) The length of large data segments cannot exceed 
100,000*000 bytes (I.e.* 2**271. 



4*&..In£££afilLx£ 



1) If a user's terminal should become disconnected from NOS/VE* 
the job can be resumed by logging in to the system and entering 
the command ATTACH^JOS (ATTJ). The terminal will be reconnected 
to the job, and the jot? will be put Into a pause break state* The 
TERNINATE.COHMAND and RESUHE.COHHAND commands can foe used at this 
time with the same results as during a pause break. A DETAtfOIOB 
(DETJ) command has also been added to allow a user to detach a job 
by command* The DISPLAY_J0B_STATUS command Mill display 
disconnected and detached jobs. Detached jobs will be 
terminated after a system defined time has elapsed. 

2) In order to use a C0C 721 terminal on NOS/VE* the 
following command should he entered? 

SET.TERHINAL.ATTRIBUTES TC-T4010 

3) Access to MOS/VS CVEZAF) via a X25 connection will cause 
the terminal land its NOS/VE job) to hang. The hang 
state can be cleared by entering any TIP command* 

such as escape-CH. Code to fix the problem In CCP is 
available and Is associated with PSR number CC5A230. 

4) NOS/VE Rl.0.2 does not support an END-GF-INFORHATIGN *E0I) 
facility for indicating to an interactive program that the 
user wishes to terminate interactive Input of data. The 
input must be ended by a count or by detection of a particular 
input value* 

PSR NVQE484 

5) If an interactive job is using a display type terminal 
<CRT) and the page width terminal attribute is not set 
to exactly the png% width of the terminal* then 
overprinting of some lines will occur. To remedy this 
either set the page width correctly for the particular 
terminal or set the output_device attribute to printer. 



£*3~ai£k-J2£&a££I£Q£ 



If the job reaches time limit* the WHEN clause is 
repeatedly activated with normal status. If the 
«hen contains a CONTINUE* then processing continues 

In an endless loop. 
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In NOS 2.2* there are two passwords for each user. 
One is the NOS interactive job password and toe 
other Is the MOS batch job pass word* The NOS 
interactive job password is used while working on 
a terminal* It Is also used for NOS/VE login 
processing - nh&n logging into NOS/VE on an 
Interactive terminal* there is no check wade of the 
NOS/VE password for validation purposes* just the NOS 
Interactive job password. Changing your NOS/VE 
will affect only your NOS batch password. Your 
NOS/VE password must match your NOS batch password 
otherwise Interstate Communications will not work 
since it submits batch jobs to NOS* 

Note 5 When using the SET.IINK.ATTRIBUTES command* 
the NOS/VE password specified wust natch the NOS 

batch job password. 

Mote i The selection of passwords for NOS and NOS/VE 
must conform to the definition as given In the NOS 
Reference Hanual for the NOS password and the NOS/VE 
Command Interface Reference Manual for the NOS/VE 
password. You have to take the common parts of both 
definitions to make a password that works for both 
NOS and NOS/VE. 

To change your NOS/VE password* enter the SET.PASSWORD 
command on the 180 side s 

Setpw oldpw newpw 

where oldpw is your current NOS/VE password and 
newpw is the new password. 

To change your NOS batch job password* you will 
have to submit a NOS batch Job. Login to the 
170 side and create a file to submit this job. 
The file should contain the following i 

40BCARD. 

USER < user nam* userpw ) 

CHARGE**. 

PASS iiORC us erpw* newpw) 
END 

mh%r% user nam is your user nam a* userpw is your 
current NOS batch password* and newpw is your 
new MOS batch password. Your original NOS batch 
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password is set to your original MOS interactive 
Job passwords* All of the above commands in 'the 
file created snust be typed in capital letters* 

To submit this job* type in t 

submi t* 1 fn*b» 

wh®re I f n is the file you created* 

In order to change your NOS interactive job 
password* type in on the 170 side s 

passu or * ol dp*** nenpw* 

Mhere oldpw is your current NOS interactive 
password bt\4 newpw is your new interactive 
job password* 

AaJlJHS£UX^IaARX-Lflfi 

ixllxl.SIiELil-MMiEI.LSS 

OXSPLAY.BINARY^LOG is a command utility that processes the 
contents of the global binary logs C statistics* accounting *t\$ 
engineering) into human- readable reports and graphs* There are 
no pre-packaged reports built Into DXSPLAY_8INMY_L0G! instead* 
user sub-commands specify the statistics to be extracted from the 
log and the types of analysis to be per formed* Input to the 
program may be either an active system log* or a permanent file 
copy of a log as produced by the Term! na te_Log command* The 
information to be extracted from the log* and the type er\6 format 
of the reports produced* is specified by sub- commands supplied by 
the user* 

PDT disbl.pdt C 

input* i t LIST OF FILE 

type* ts KEY statistic* statistics* account**** 

accounting* engineering * statistic 
output* os FILE * SOUTPUT 
status ) 



This command* which may be abbreviated 01$ BL* enters the user 
Into the command utility environment. Subsequent sub-commands 
Mill be prompted for by the string "DISBL/"* 
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The binary log to be processed may be either a currently-active 
system log* or a copy of a terminated log. If an active log Is 
to be used* the TYPE parameter specifies the desired system 
global log* and the INPUT parameter Is omitted* If a terminated 
log Is to be used* the INPUT parameter specifies the file nape* 
and the TYPE parameter is omitted* If a list of file names is 
provided for the INPUT parameter* < the data will be processed as 
if the contents of these files btb concatenated in the order that 
the files are specified. 

The OUTPUT parameter specifies the file on which the reports 
generated by 0ISPLAY.8INARY.LOG are written* All current reports 
are formatted for a p&Qe width of 132 columns. 

The first output page generated by DI$PLAY_.BIRARY._LOG lists the 
input files processed and the beginning and ending dates and 
times for each f i I e. 



£*U&i*£-2££iaitl£D.Siiii=sfiflia£2d2 

The user extracts data from the binary log by first specifying 
one or more groups of statistics* and then specifying one or more 
metrics (numbers expressing a measurement) to toe derived from 
each group* For example* one group might consist of the 
end-of-job statistic for each job run on the system* and an 
associated metric might be the CP time consumed for each Job* 

Final reports are generated through the use of a set of DISPLAY 
sub- commands. The particular DISPLAY sub-command used specifies 
the form of the report (histogram* statistical summary* etc*)* 
Bnd parameters to the sub- command specify the metric or metrics 
to be displayed* and additional information about the form of the 
report* 

To economize on execution time* 0ISPLAY.8INARY.L0G processes all 
sub- commands* up to the QUIT sub-command* before generating any 
reports. The binary log need be scanned only once* and ail 
reports are generated in parallel* They appear on the final 
output file* however* in the order in which their sub-commands 
were Issued. 

As each group and metric is defined* It Is given a user-chosen 
name* which is subsequently used to refer to it. These names may 
be up to 31 characters in length* nnd follow the usual SCL 
conventions for names. The group or metric identified by a given 
name need not be defined before the name is used* but must be 
defined before the QUIT sub-command that terminates the 
sub-command set. 
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POT dafg.pdt < 

group*g* NAME * $RE9UXRED 
statistics si NAME 
times t: RANGE OF tiwe.value 
date* d* RANGE Of date.value 
job.predecessor* Jpi NAME 
task.pradecessor* tp: NAME 
descr iptlve.data* dd* STRING 
between* b* LIST 2 OF NAME 
) 



This sub-corn® and defines a statistic group* The GROUP parameter 
supplies a name for this group* and is required. The other 
parameters are ail optional* and specify conditions which each 
statistic must satisfy before it will be part of the group* If 
two or' more conditions are specified* a statistic must satisfy 
all conditions specified before it will be included in the group. 

The STATISTIC parameter specifies a statistic Identifier* 
Statistic identifiers are of the for* AANNNNN* where AA is two 
alphabetic characters* and NNNNN is a decimal number* For 
example* AV260007 is a statistic emitted by the accounting and 
validation code at end-of-job. 

The TIHE and DATE parameters can be used to limit the tine period 
within which statistics will foe recognized. The default range of 
time is from 00*00:00 to 23*59359* The default range of date Is 
from ©0/01/01 to 12/31/^9. If only one value is specified for a 
parameter* instead of a range* then the provided value will be 
taken as the lower limit of the range* and the default used for 
the upper I imi t. 

The DESCRIPTIVE.9ATA parameter supplies a string which is matched 
against the contents of the descriptive data field in each 
statistic. Hatching is performed character-by-character to the 
end of the parameter string. If the descriptive data field in 
the statistic Is longer than the parameter string* the excess 
characters are ignored. 

The TASK. PREDECESSOR parameter is used In combination with other 
parameters on the DEFINH.GROUP sub-command to relate two or more 
statistics issued by the same task. The TASK.PREDECESSOR 
condition Is satisfied if the task Issuing the statistic also 
previously issued another statistic* which is a member of the 
group specified for the TASK. PREDECESSOR parameter. 

For examples 

Define.group compi I e.tasks statistic « PM23C0G2* •• 
Jescriptlve.data • *FCP$COHPILE_ FORTRAN. SOURCE* 
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Deflne.group compl I e_en«Lof_t ask statistic « P$23<l§03* .. 
tisk.predace.ssor • comp i I e.tasks t*O8s00tOO««X6sO0tO0* •• 
d«0X/0X/83..OX/0X/83 

These commands define a group called co«p! 1 e.end.of.task that 
contains the and of task statistics for all FORTRAN compilation 

tasks* 

The J0S_PREDECE3$0R parameter is used in combination with other 
parameters on the DEFINE.GROUP sub-command to relate two or more 
statistics issued by the same job. The JQ8_PREDECESSGR condition 
is satisfied if the job issuing the statistic also previously 
Issued another statistic* which is a member of the group 
specified for the JQB.PREDECESSQR parameter. 

The BETWEEN parameter is a future feature. It is currently 

accepted* but ignored. 

PPT defm.pdt < 

metric* it NAME * SRSQUIRED 
group* g? NAME ■ $R£QUIRE0 
seal e.f actor* sf* INTEGER 
unit* us STRING 
counter* c* INTEGER 1..63 
expression* e: STRING 
) 



This sub-command defines a metric* The METRIC parameter 
specifies a name for this metric* and is required* The GROUP 
parameter is also required* and specifies the group from whose 
members this metric is to be derived. 

The SCALE_F ACTOR parameter Is used to adjust the values of the 
resulting metric in order to make them easier to understand or 
use. Each metric element is divided by SCALE_FACTOR before being 
used to generate reports. IF this parameter is not specified on 
the DEFINE..METRIC sub-command* a value of 1 is used for the scale 
factor. 

UNIT is an optional parameter that can be used to provide a 
string identifying the measurement unit associated with the 
values of this metric. If a unit is supplied* it is used to 
label that metric in all output reports. If the UNIT parameter 
Is not used* it defaults to blanks. 

The other parameters specify different ways in which a metric can 
be derived from the members of the group. One and only one of 
these parameters can be used in a given OEFXNE.NETRXC 

sub-command. 
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COUNTER specifies the Index of one of the 63 possible counters 
included in a statistic. The contents of the specified counter 
for each statistic in the group make up the resulting metric* 

EXPRESSION specifies an arithmetic expression that is evaluated 
to yield the value of each metric element*. At present* the only 
expression that Is accepted by DISPLAY„BINARY_LOG Is f l f * This 
expression is used to count the number of elements in a metric* 



This group of commands is used to specify reports to foe written 
to the output file* As noted above* all commands are processed* 
up to the QUIT command* before any reports are actually 
generated* The reports appear on the final output file in the 
order in *hlch their sub-commands Mere issued* 

POT diss_pdt ( 

metric* m. NAME « SREQUIRED 

title* ts STRING 

) 



This sub-command requests a statistical summary report* This 
report includes such information as the mean* maximum and 
minimum* and total number of elements of the specified metric* 

The HETRIC parameter specifies the metric to be reported* and is 
required. 

The TITLE parameter way be used to provide a title to be placed 
at the top of the report page. If omitted* the metric name is 
used* 



4*ll*l*.axZ.i2IS£LAY-DISiaiByiIO^-.SMll=fia3Bl*Dd 

POT disd ( 

metric* m? NAME * $R£ QUIRED 

title* t i STRING 

limits, limit, fi <( II* 12 >* < 13* 14 ))s INTEGER 

dlspl ay.option* do* KEY max_min_bound* f ir st_ffiax_centered* 

second.max.centered * max_min_foound 
x.interval* xi* KEY sal f_adjust* large* medium* small * 

self. ad Just 
J 
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This sub-command requests a distribution Plot* which indicates 
the number of uatric elements with each value within the observed 
range* The report consists of a frame indicating X and Y axises* 
with the possible values of the metric on the X axis* and the 
element count on the Y axis. 0rSPLAY_8IMARY.LOG places asterisks 
within the frame to indicate how many metric el events had a 
particular value* The report also displays the numbar of 
elements within the frame and the number of elements which exceed 
the f rasie I i in its • 

The functions of the METRIC and TITLE parameters are the same as 
in the DISPLAY.SIWWRY sub-command. 

The LIMITS parameter can ha used to define the frame boundaries. 
The defaults on the X-axis are the minimum and maximum of the 
contents in tha counter. On the Y-axis* the defaults %rz the 
ninimum and maximum number of elements assong X- axis Intervals. 
First value set defines the X boundaries* Second set defines the 
Y boundaries. First value in each sat defines the lower 
boundary. f -l' can be used to specified a default boundary. 

EXAMPLES* 

l*U 50* 1000 I) X lower bound » 50* upper bound * 1000 

Y boundaries are default. 

1«M -1* 1000 I* X lower bound * default* upper bound ■ 1000 
C 10* -1)1 Y lower bound * 10* upper bound * default 

The DISPLAY. OPTION parameter can be used to select first maximum 
or second maximum < on Y-axis ) portion of the graph. 
FIRST.HAX.CENTERED* SEC0N0.MAX.CENTERE0 and MAX.MIN.BOUND are the 
keywords. The default of this parameter Is MAX.MIH.BOUND. 

The X. INTERVAL parameter can be used to determine the number of 
intervals into which the X-asis of the frame Is divided. 3 
different sifces are available* 

LARGE - X-axis Is divided Into 11 Intervals! 
MEDIUM - X-axis is divided Into 21 intervals? 
SMALL - X-axis is divided into 101 intervals. 

The default of this parameter is SELF.AD4UST. When default is 
used* the X- axis division will be depend on the X-axis limits 
alone. The rules are? 

X. upper. bound - X_lower. bound <* 10 11 intervals 
X.upper_bound - X. lower. bound <* 500 21 intervals 
X.uppsr.bound - X. lower. bound > 500 101 intervals 
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!• The first and the last intervals on the X axis are 
one-half the width of the other X axis intervals* 

2* The X-axis ypper limit as displayed way be slightly higher 
than the value specified in the subcommand* The rules are* 

11 intervals t X.upoer - X.lower I modulus 10 « 

21 intervals ( X. upper "- X.fower I modulus 20 * § 

101 intervals C X.upper - X..I otter 1 modulus 100 * 



POT dlstd.pdt< 

metric* mi MAHE » SREQUIREO 

metric.! imits, alt LIST 2. .2 of INTEGER - SREQUIRED 

title* ts STRING 

) 



This subcommand generates a grnph which plots metric values 
against time* The X-axis represents the time Intervals and the 
Y-axis represents the element counts of the metric* The 
asterisks placed within each time Interval represent the range of 
element values seen in that interval* The report also generates 
the number of elements within the frame and the number of 
elements which exceed the frame limits* 

The METRIC parameter specifies the metric name to be reported* 

The HETRIC_LINITS parameter specifies the limits to be used for 
the Y-axis* The limits for the X-axis will come from the date 
and time parameters given on the DEFINE. GROUP subcommand. 

examples ml=C0»500) Y lower bound « 

Y upper bound « 500 

The TITLE parameter is used to provide a title to be placed on 
the top of the report page* If omitted* the metric name will be 
used* 
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POT disdd_pdt < 

group* g* NAME « SREQUIREO 

title* ti STRING 

) 



This subcommand processes the member's of a group* rather than a 
netric* It displays values Iup to 256 characters long) for the 
descriptive data field of each statistic in the group* together 
with the number of times each value was encountered. 

The GROUP parameter specifies the group to be scanned* and is 
required. 

The TITLE parameter may foe as&4 to specify a character string to 
be pieced at the top of the first page of the report. If It is 
not included in the sub-command* then the name of the group is 

used Instead. 



POT dumg.pdt < 

group* gs NAHE * SREQUIREO 

counter_f ormat* cf* LIST 1..63* 1..2 range of INTEGER 1..63 
title* t» STRING 
) 



This subcommand processes the members of a group rather than a 
metric. Each statistic within the specified group is listed In 
full. This group dump is particularly useful for debugging group 
specifications and statistic definitions. 

The GROUP parameter specifies the group to be dumped* and is 
re qui red. 

The COUNTER.FQRHAT parameter specifies in what base the counters 
will be displayed. The default base is 10. 
ex amp I es cf*{ C1..8*10)* < 9.. 63*8) ) 

Counters 1-8 will be displayed in base 10. 

Counters 9 - 63 will be displayed In base 8. 

The TITLE parameter may be used to specify a character string to 
be placed at the top of the first page of the dump. If it is not 
included in the DUHP_ GROUP sub-command* the name of the group is 
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PDT gangf^pdt C 

group* gs NAME * $REQUIR€D 
output* OJ FILE » SOUTPUT 
permanent* p* BOOLEAN • FALSE 
) 

This subcommand selects a group of statistics defined by 
sub.coiinand DEFINE.GRQUP* and writes the statistics to a legible 
file in a format suited for machine processing* 

Tha GROUP parameter specifies the group to be selected* and is 

required* 

The OUTPUT parameter specifies the local file name which contains 
the selected statistics* If It Is not Included in the 
subcommand* the name SOUTPUT is used as the default file name. 
The attributes of the output fife will bet 

FXL£_€OHT£NTS * LEGIBLE 
FILE.ORGANIZATIQN - SEQUENTIAL 
FILE.PROCESSOR « UNKNOWN 
PAGE.FORNAT » CONTINUOUS 
PAGE.WIOTH - 80 

C Except for the file SOUTPUT* where the default attributes of 
SOUTPUT are used. ) 

If the same file name is used for OUTPUT parameter in several 
GENGF sub. commands* the order of the group statistics will be the 
same as the order of the GENGF subcommands* 

The PERMANENT parameter is a boolean value. If PERMANENT * TRUE* 
then a permanent file with the same name specified in parameter 
OUTPUT 'm\ II be created under the catalog $JSER« If the permanent 
file is an existing file* then a new cycle C one higher ) will be 
created. The default value of this parameter Is FALSE. 

There are some restrictions when parameter PERMANENT s TRUE is 
spec! f ied. 

1. Parameter OUTPUT can not be the default value or $0UTPUT. 
The conflict of the file attributes will cause the 
subcommand to be rejected* 
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2. Parameter OUTPUT can not be the sane as Irs any previous 
GENERATE. S&OUP.FILE sub.oomfflands • The local file name 
conflict nil! cause the su5_coa«and to foe rejected* 

3* Parameter OUTPUT can not be the sasie as an existing local 
file name*: The local file naiae conflict nil! cause the 
0ISPLAY.BINARY.LOG to be aborted* 

The PERMANENT parameter Is not consistent alth NOS/VE philosophy* 
Bn^ «ay foe removed In a future update* This will not deprive 
users of any functionality* 

Ex amp I ess 

CASE 1 ( illegal usage > 
defg g«open_input s-evlOOO 
QBHQf g»open_ input PERMANENT*TRUE 

CASE 2 I illegal usage ) 
def j g*open. input s«evlOOO 
dafg g-cl ose.lnput s*evl001 
GENGF g-open.. input OUTPUT-INPUT..GROUP 
6ENGF g*cios«.input OUTPUT- INPUT.GROUP PERNANENT«TRUE 

CASE 3 ( legitimate usage ) 
dafg g=open_input s-evlOOO 
defy g»cl ose.input s*avl001 

SEHGF g=open_in»ut OUTPUT»INPUT_GRQUP PERMANENT-TRUE 
GENGF g-c lose. input OUTPUT- INPUT. GROUP 

Each statistic is output as q^b or raore text lines. The first 
line contains the header information* including the nussber of 
counters and the size of the descriptive data string. The 
counters are output next* occupying as stiany lines as necessary* 
The descriptive data string is output last* on a single line. 
The format of each statistic In the output file Is shown belon* 



Line 



from Ch. 



1 


2 


1 


4 


1 


11 


1 


19 


1 


32 


1 


38 


1 


47 


1 


70 


1 


73 


2 


1 


2 


21 


2! 


41 


2 


61 


3 


1 



to Ch. 

3 

9 
17 
30 
36 
45 
68 
71 
75 

*>£% 

40 

60 
SO 
20 



Conte nts 

stat 1st ic.l dent if ier 
stat Istic.code 
Julian date* yyyyddd ) 
tiaieC hhMnfuJss.ml 1 1 I second ) 
Job.nana 

global _ task. id < nnnn-mmi ) 
condens Ing.f requency 
number. of .counters 
descrl ptl ve_deta_slze 
counter 1 C right justified* 
blank filled ) 



counter 
counter 
counter 
counter 
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n—1 
n 



80 



descriptive data 



This sub-command has no parameters* It ends acceptance of sub-commands* and 
begins processing of the prior sub-commands to generate reports* 

This command is used to establish and enable one or more statistics to a given 
global binary log* It may be abbreviated as "ACTS*. The POT is* 



PDT acts.conmand C 

statistic* statistics* s* LIST QF NAME « SREQUIREO 

type* ts KEY statistic* statistics* accounting* account* ... 

engineering « statistic 

STATUS ) 



The STATISTIC parameter specifies one or more statistics to be 
established and enabled. Each statistic is specified as two 
alphabetic characters followed by a decimal number 1 for example* 
AV260007* A list of statistics* enclosed In parenthesis as pbt 
SCL syntax* may be specified* 

The TYPE parameter specifies the global binary log to which the 
specified statistics are to be enabled. Only one log may be 
specified in each ACTIVATE.STATISTIC command. If It Is desired 
to sand a particular statistic to more than one log* multiple 
ACTIVATE.STATISTIC commands may be used. 

fAll A 3.IbB-fi£A£IIVAI£.SIAII&II£.£AioaDd 

This command is used to disable one or more statistics that had 
previously been enabled to a particular log. Ail statistics 
remain established* and if they %r9 enabled to another log* that 
connection remains undisturbed. The command name may be 
abbreviated as OEAS. 
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PPT deas.comsiand C 

statistic* statistics* s* LIST Of NAHE * $REQUIRE0 

type* ts KEY statistic* statistics* accounting* account* *** 

engineer i ng * statistic 

STATUS I 



The STATISTIC parameter specifies one or aiore statistics to be 
disabled* Each statistic Is specified as two alphabetic 
characters followed by a decimal numbers for example* AV260007* 
A list of statistics* enclosed in parenthesis as per SCL syntax* 
pay be specified* 

The TYPE parameter specifies the global binary log to which the 
specified statistics are to be disabled* Only one log may be 
specified in each DEACTIVATE.STATISTIC command. If it is desired 
to disable a particular statistic from more than one log* 
Multiple DEACTIVATE.STATISTIC commands way be used. 

All statistics specified In the DEACTIVATE.'STATISTIC command must 
have previously been enabled to the specified log* either by an 
ACTIVATE.STATISTIC command or by a program Interface call* 



4xU**-ACIim£.lHI£mL-SIAII£IIC 

The ACTIVATE.INTERVAL.STATISTIC CACTIS) command is used to 
establish and and enable those statistics which are emitted on an 
Interval basis to a to a given global binary log* This command 
can only be issued from the system console* 



POT actis.coiRfliand ( 

Jms_interval * ji: integer 1**999 * 1 
pms.lnterval* pi? Integer 1..999 * 5 
status ) 



The STATISTIC parameter specifies the statistics to be emitted* 
The only valid statistics of this type currently is the QS210GQO 

and aS210001 statistics* 

The JMS. INTERVAL parameter specifies at what time interval the 
jms statistic (0S21G0G0) should be emitted. The default value is 

1 minute* 

The PMS.INTERVAL parameter specifies at what time interval the 
m$ statistic (QS210GG.1) should be emitted. The default value is 
5 minutes* 
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The DEACTIVATE. XHTERVAL.STATISTIC (DEAXS) comfflmand Is used to 
disable interval statistics that have previously been enabled to a particular, 
log* This command only disables the QS210000 and 05210001 statistics* 
This command can only be issued from the systei console* 



PDT dsais.coflimand ( 
status ) 



i*ll*6-SIAIlSIICS-A^ILAaU-IU-IlQSZX£ 



This is a list of the current statistics available on NOS/VE. 



STATISTIC 



NAME 



CDUHTER/OESCRXPTIVE DATA 



AV26O0O0 



Accounting CP time 



CI J Total CP increment 
C2s Job-wode CP time incr* 
C3: Hon! tor-mode CP time incr* 



AV2603G1 
AV260O02 
AV 26000 3 



Accounting Page faults 
Accounting working set 
Accounting Ready Tasks 



Cls Total page fault incr* 

CI 5 Current W*S* size 

Cls Current ready task count 
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AV260006 Accounting Begin Acent» 



av26o<io? 

AV26OO08 

cl 170000 

CL 170001 

JH18QO0O 
JM180001 

JHI80002 

JH180Q03 



PH23000Q 
PH23Q001 



PH 2 3000 3 



PM23Q004 

PM2300G5 



Accounting End Account 

Accounting SRU*s 
Display message command 

Command n%m$s 

User name 

Job name 
Job mode 

Job end 



Task begin 

Task Starting Procedure 

Task nana 

Task end 



Loader begin 
Loader end 



FC580000 



Fortran Compilation 
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DOS 1-31 - account name 
32-33 - f # • 
34-64 - project name 

CU Total job SRU«s 
C2s Total job CP time 

Cls Total SRU increment 

00s String specified in 
coin $ and 

POs Name of command! upper 
case* 31 characters 

00: User name! 31 characters 

DDs User's job name! 31 chars 

00: • INTERACTIVE* or «BATCH*J 
11 characters 

CI s CP time - job mode 

C2s CP tine - monitor node 

C3s Page faults 

€4 : Page- ins 

C5: Page-reel aims 

C&s Page-assigns 

None 

DD s Starting procedure name! 
31 characters 

DDs Task name! 31 characters 

Cls CP time - job mode 

C2s CP time - monitor mode 

C3s Page faults 

€4: Page-ins 

C5s Page-reel aims 

C6: Page-assigns 

none 

Cl$ CP time - job mode 

C2s CP time - monitor mode 

C3s Page faults 

C4 s Page- ins 

C5* Page-reclaims 

C6* Page-assigns 

Cls Task time In compiler 
C2: Monitor time 
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Fortran Program Unit 



OS 2 10000 



JHS-interval 

(job-fa Binary interval) 



0S2100O1 



PHS-lnterval 
(pacjing-inoni tor 



interval ) 



€3* Ho* 
C4s No* 
C5* Ho* 
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of lines compiled 
of statements 
of program units 



DO* 
CI* 

CZt 
C3* 

€4* 

CI • 

C3* 

€4* 
C5* 
C6* 
C7* 

C8 i 
C9i 

CIO* 

cm 

Cl 2* 
CI 3* 
C14* 
€13* 
C16* 
€17* 
C18* 

Cl * 

C2 * 

€3*. 

€4* 

C5* 

C6* 

C7* 

C8* 

C9s 

CIO* 

cm 

C12i 

C13* 
C14* 
CIS* 
C16* 
C17* 
CIS* 
C19? 



Program unit nane 
Task time for unit 
Monitor tlase for unit 
No* of lines in ynit 
Ho* of statements 



free pages 

aval I abie pages 

available modified P3ges 

Mired pages 

shared pages 

fixed pages 

IG error pages 

Job sh^r^6 pages 

job working set pages 

swapped jobs 

ready tasks 

interactive class 

batch class 

site class 

site class 1 

site class 2 

site class 3 

maintenance class 



pf aval lable 
pf aval table 
pf disk read 
pf new page 
pf locked 
Pf 10 reject 
force aggresive 
aggresive aging 
aggresive aging 
aggresive aging 
page 



modi f I ed 



aging 

shared queue 
job queue 
failed 



write aged 

mr cycle 

mr cycle 

mr delay 

mr del ay 

air wait 

mr nalt average duration 

mr write modified pages 

mr write modified pages 

average duration 



average duration 
average duration 
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Tha ADHINISTER.USER utility can be run froai a batch job 
or SCL procedure contrary to what the Family Administrator 
for NOS/VE Usaga Manual says* 
PSRs HVEA045 and NVEA046 
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1) When using DEBUG to breakpoint on a multi-line 
statements the line number supplied to DEBUG must 
be the fast line number of the statement. 
CILA498 

2) Cybi I prohibits the user from defining an integer 
greater than 48 bits. This has be^n fixed in the CycJe 
18 compiler version 83333* 

PSR CILA609, PSR CILA515 

3) The 256th character of an SCL string variable cannot be 
set to any character other than a space* This is 
corrected in CYBIL 83333 for Cycle 18. 

PSR CILA634 

.SxiLCOfiQL 

1) The COBOL READ REVERSE statement does not work. If used* 
it will loop Indefinitely on the first record and never 
take the AT END path. This is the result of 8AM failing 
to set the file position to 801. 

PSR NV0EC44 

2) Tao consecutive instances of OPEN OUTPUT on the same indexed 
sequential file hJ 1 1 not cause a message warning that the 
data has he&n evicted by the second OPEN. The user should 
refrain from issuing another OPEN OUTPUT once the file has 
been created. 



PSR AA8&IQ6 



SaS-IAEE-IZQ 



1) Tape support is limited to and intended for use by the 
permanent file backup and restore utility. Use of tape 
I/O for any other purpose way produce undefined results* 

2) Whan preparing to mount a tape to be read by NOS/VE* the heads on 
the drive should first he cleaned. This is recommended before 
each tape mount due to the currently Incomplete luplenentet ion of 
error recovery. 
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1) Do not use the file name INPUT In batch node* It Is 
alttays a null (empty) file with no data In it* Choose 
a different name* This affects migration 
of jobs frow M05* where the name INPUT »as the Job's 
Input deck* On NOS/VE use the COLL£CT_T£XT command to 
create the inpyt data* 

I) Whan using FRU and inside Interstate Communication 

Facility, do not do a CLEAR on the EXeCUTE.INTERSTATE 
CQMAND. This will clear FMU checkpoint files and 

render FHU inoperable* 

1) When using READ (* .**) in batch jobs* a file 

containing the desired input must foe connected to 
SINPUT by CREATE.FILE.CONNECTIQN or equated to INPUT 
on the FTN program statement or LOO statement* 

Z) If INPUT or OUTPUT Is opened using an OPEN statement* 

must be changed to use SINPUT or 

3) To insure correct listings and Improve compilation performance 
it is necessary to prevent the listing file and the errors file 
from being the same file* In batch Jobs both would default to 
$0UTPUT. To avoid this set the ERROR parameter on the FORTRAN 
command to a file reference different from that of the LIST 
parameter . 

£jL&~&ig£a&eji_&££££&_a£j;l2£4& 

A job using an indexed sequential file will fail due to 
entry point errors from the loader* 

The fol lotting command executed earlier in the job will 
correct this: 

SET.PROGRAH.ATTRIBUTES TERHINATION_£RROR_LEV£L«FATAL 
or SETPA TEL*F 

P3R NV0C941* NV0E276 



If 


INPUT 


or 


OUTPUT 


the 


OPEN 


statement 


SOU 


TPUT. 







- COMPANY PRIVATE - 



SOFTWARE RELEASE BULLETIN 

84/02/1Q 
NOS/VE (CYCLE 11) 

1) The SCU editor command SEARCH..BACKUARD will hang if 
asked to locate multiple occurrences of a range of 
text* A terminate break will stop the hung command 
and allow the user to continue editing* 
PSR SC8A027 



21 An anomaly can occur when som& modifications are 
excluded when a deck Is expanded. An example 
is below? 

Line 1 version 1* 
is introduced by modification A* Modification 8 
replaces this line with 

Line 1 version 2* 
Then modification € in turn replaces this line 
with 

Line 1 version 3* 
If one expands the deck with modification B 
excluded both the lines Introduced by modifications 
A and C will appear in the COMPILE file* 

5*SJ££fldlifii_Ssi-=_fl£flU£ 

If a job calls a procedure In a lower-numbered ring and 
that procedure causes an error* then Debug does not give 
a proper indication of the problem* Debug reports 
that ?H INVALID SEGMENT has occurred In the user's program 
at the line which originally called the (faulty) procedure* 
This situation can occur when a CYBIL program calls an OS 
procedure and the OS procedure does something wrong* 

Ixl£_Qu_Lin£..?2iauai2 

Help (also known as EXPLAIN_MESSASE) does not exist In the 

system* 
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The 8ATCHIQ printer driver does not correctly handle long lines 
Cover 135 characters). The extra characters are either dropped* 
overprinted* or cause the page to be spaced erratically* 

NS2C1.21 



COMPANY PRIVATE - 



SOFTWARE RELEASE BULLETIN 
NOS/VE <CYCLE 17) 
2i.^££i«L£^£LS 



44 
84/02/10 



The foloMing tables show the microcode and controiware levels that 
were used to validate the NOS/VE system on the specified hardware 
systems supported* These tables show the latest official FCA levels 
of the hardware and microcode and the necessary modifications 
Cdeviations) required to support the NOS/VE system* Tables 1# 2$ 
3.» and 4 correspond to the €170-815, €170-825* C 170-8 35* 
C170-845* and €170-835 systems* respectively* 
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A1,0 Q£3tU£-£aA&A£I£RISII£S 1 

2 
3 
% 
5 
6 

il.l QI&K.fi£)£I£££ 7 

8 

9 

Al.1.1 PHYSICAL CHARACTERISTICS 10 

11 

12 

844~4x 885-lx 13 

14 
Spindles/Cabinet 1 2 IS 

Cylinders/Spindle 823 843 16 

Tracks/Cylinder 19 40 17 

Sectors/Track 24 32 18 

Bytes ie bit)/Sector 483 516 19 

20 

21 

22 

Al.1.2 LOGICAL CHARACTERISTICS 23 

24 
25 

Al. 1*2*1 I&£ilaaiaji 26 

27 
28 
29 

• Al iocation_unJt - The quantum of assignment of mass storage 30 
space to a file* An a! location.unit is a power-of-two multiple 31 
of consecutive DAUs. At present* the al locati on.unl t is not 32 
selectable on a file by file basis? all end-user files default 33 
to 16384 byte allocation* 34 

35 

• Device.ai I ocation.uni t COAU) - The quantum of allocation of a 36 
mass storage volume (spindle). NOS/VE views a device as an 37 
array of OAUs which individually or as a contiguous group 38 
(called an ai I ocation_unit) may be assigned to a mass storage 39 
file* A OAU consists of an integral number of MAUsj the ratio 40 
is device dependent and <iepen^ent upon the granularity of 41 
allocation MOS/VE can afford to provide for a particular device* 42 
A DAU way span tracks but never spans cylinders of a device* 43 

44 

• Large.sector - A controlware capability provided by the 7155 45 
class of mass storage controller which logically groups four 46 
physical sectors Into one for the purpose of decreasing device 47 
driver overhead. The term f MAU* is preferable to * large sector* 48 
since not all controllers may provide this capability to NOS/VE* 49 
Note that a farge_sector on an 885 device is composed of four 50 
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A1.0 DEVICE CHARACTERISTICS 
Al*l*2*l Terminology 



phys 

of 

read 

MOS/ 

prev 

diag 

sect 

stat 

sect 

Sect 

reco 

stat 



J cal 
the s 

in 
VE 
lous 
nost 
or. 
us 
or d 

Of 

us. 



sector 

a byte 
small s 

wi I 1 
I y on I 
t c is 

The co 
in t«f 
I ajnost 
address 
ded tha 



s each 
s are 
ector 

encoun 
y acee 

pro* id 
ntrol wa 
fllS of p 
i os sue 
. «he 
t one f 



of 
no 

mod 

ter 

sse 

ed 

f e 

hys 

h a 

n 

ely 



which co 
t transf 
e . The 
add i t 
dins 

to y er 
and NOS/ 
leal Ism 
s PI, 8 an 
using t 

on the 



ntai ns 
srred 
f ef of e 
iona I 
ma! I 
ify t 
V£ con 
all! s 
d FLO* 
he la 
sector 



516 bytes. The last 33 
when a physical sector is 
t It is possible that 

bad-spots on a device 
sector node* The DL8 
he data field of a large 
slstantly report failure 
ector address* The large 

however* display large 
tter diagnostics* It is 

address in the detailed 



Mini muin_address 
supported by a 
is used to n 
Central Process 
storage device 
driver then bre 
sectoring consi 
size which is n 
844-4x1 § then 
finish in the m 
spanned is de 
spans cyl inder s 



abie.unit CMAUI - The 
PP driver* The HAU is a 
orwalize the various de 
or* When the CP prep 
s it thinks In terias of 
aks down the HAU i nt 
derations* If a mass st 
ot a power of two bytes 

the HAU will begin ft 
Idst of the last sector; 
vice dependent* An HAU 

of a device* 



quantu 

sof twa 

vice se 

ares r 
a n u* be 
o phys 
orage d 
in leng 
the sta 
the n 
may spa 



m of data 
re conce 
ctor size 
equests 
r of MAUs 
ical add 
evice has 
th (such 
rt of a s 
umber of 
n tracks 



transfer 
pt which 
s for the 
for mass 
• The PP 
ress and 

a sector 

as the 

ector and 

sectors 

but never 



Page.size - A power of two number of bytes ranging from 512 
bytes to 65536 bytes* NOS/VE is presently constrained to 
supporting page sizes of 2048* 4096* 8192 Bn4 16384 bytes* The 
constraint is a file system constraint related to a}not wanting 
more than one page p^r HAU and b) not wanting a page to span 
tracks* 



ai. i. 2. 2 tiam£-iUsLfc_mua£_mii£jatiaja 



Sectors/! 
HAU/ Track 
DAU/Track 
DAU/Cyi inder 
OAU/Sp indie 
Bytes/HAU 
8ytes/Track (avg*) 
Bytes/Cyl inder 
10**6 Bytes/Spindle 
10**6 Bytes/ Segment 



844-4X 


865-ix 


5 


4 


4.8 


8 


2.4 


4 


44 


160 


37035 


134880 


2048 


2048 


9485*4 


16384 


180224 


655360 


151.6 


552.46 


2147.5 


2147.5 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
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A1.0 DEVICE CHARACTERISTICS 

Al.1.2.2 NOS/VE Disk Volume Allocation 



A l . l . 2 . 3 H01£E£«£I1 n-kllas. a£1a& 



A I I oca t i on Un 1 1 Si z* J 

(Consecutive DAUs) 

1 
2 

4 

8 
16 

32 
64 
128 
256 



844-4x 


865-lx 


(bytes) 


(bytes) 


4096 


4096 


8192 


8192 


16384 


16384 


32768 


32768 


65 536 


65536 


■*• *# -X : W * -& 


131072 


180224 


262144 


180224 


524288 


130224 


655360 



A1.2 IA££.fl£idI££S 
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A2.0 aASS-SiaaAfi£-3£aLUa£.UitlAfi£15EllI 1 

2 
3 
4 
5 
6 

A2.1 mi£fi-IaSIftUmQli_E&EEa&AII!». 7 

8 

9 

A2*1.I PREPARING 844 AND 885 DEVICES 10 

11 

12 

13 

All 844 and 885 volumes are formatted at the factory. Neither 844 14 

nor 885 volumes need to be reformatted to he used by NOS/VE* Volumes 15 

used by NOS are Interchangeable with NOS/VE without re-f ormattlng* 16 

Utility Hap processing is identical in all aspects* However* with the 17 

exception of the Factory Hap and the Utility Hap* the data recorded on 18 

a volume by NOS cannot be interchanged with NOS/VE and vice versa* 19 

20 
NOS/VE does not honor the CTI deadstart sector content* Therefore 21 
it does no good to install CTI or CML on a NOS/VE device nor can one 22 
expect this information to remain Intact across nixed system use of 23 
the device* e.g. first NOS* then NOS/VE and then NOS again* CTI and 24 
CML should only be Installed on the NOS deadstart device or an 25 
alternate device used only by NOS. 26 

27 
Prior to attempting NOS/VE system installation* the following 28 
procedures should be performed either on-line using MALET on NOS or 29 
off-line usin^ DEMOT* The objective of these procedures is to ensure 30 
the correctness of the Utility Map maintained on each device* The 31 
INITIALIZE_NS_VOLUME process described later uses the Utility Map to 32 
avoid defects (bad-spots) on the disk surface. 33 

34 

35 

36 

A2* 1*1*1 £*stfia«0£ji4&tai:£_0fiiiG£ 37 

38 
39 

a* For the NOS/VE system deadstart device it is recommended that 40 

the SCAN DISPLAY FLAHS module of the FHU diagnostic be used to 41 

display ail the sectors which have track or sector flaws set* 42 

This display must then be compared to the display of the Utility 43 

Map* Any flawed sectors not in the Utility Hap must be added to 44 

ensure that the installation of the NOS/VE system will go 45 

smoothly* This procedure should be expected to take at least 10 46 

minutes* Refer to the discussion of defect management below for 47 

further insight as to why the above procedure is recommended* 48 

b* Use the DL8 diagnostic to write/read large sectors on Cylinder 49 

0« Track of an 885 deadstart device* This accomplishes two 50 
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things' 1) it proves that track C can later be written by 1 
INXTIALIZE_HS_VOLUME (INIHV) 2) it ensures that fictitious 2 
unracovered cnecksuis failures are not encountered by INIHV when 3 
performing NQS/VE label searching, Mote that it is totally 4 
unnecessary to write large sectors ^n the whole device because 5 
NQS/VE never reads a sector that it has not first written 6 
(except during INIHV label searching).* 7 

8 

9 

10 

A2. 1.1.2 laLm%Z-Q£ML-Ihm-£h&-S.X££m-U&&A$£Mi£-U&xl£& 11 

12 

13 

14 

The above procedure is strongly recommended for each mass storage 15 

device to be used by NOS/VE. 16 

17 
18 
19 

A 2. 2 IfclIIIALII£-aS-3tOLUfl£ 20 

21 

22 

A2.2.1 INITIALIZATION OF 844 AND 885 VOLUHES 23 

24 
25 

The INITIALXZE.HS.yOLUME (INIHV) subcommand of the Logical 27 

Configuration Utility (LCU) is used during the NOS/VE installation 28 

process to prepare mmss storage volumes for use by NOS/VE. The 29 

initialization includes writing a NOS/VE software label on the volume 3C 

m^i processing the Utility Map located on the volume itself. Before 31 

proceeding with the initialization of the volume? INIMV attempts to 32 

read a NOS/VE label from one of three possible locations on the 33 

vo tunes MAUs 1* Z and 3 are tried In succession* This is done as a 34 

protection against operator error which could destroy files on the 35 

volume if re-Initialized* 36 

37 

If an 885 volume has not been previously initialized by NQS/VE or 38 

has not been written in large sector mod* by diagnostic software* then 39 

an uncorrected checkword failure will be reported for each of the 40 

three attempts made by INIHV to read a NOS/VE label* \)n4zr the 41 

previously stated conditions* the reporting of these 3 failures is 42 

£&££&£&& and should aai be a source of concern. The 3 locations read 43 

by INIMV* in the order attempted* ares 44 

l.Cytinder 0* Track 0* Sector 45 

2. Cylinder 0* Track 0* Sector 4 46 

3. Cylinder 0* Track 0* Sector 8 MO octal) 47 

48 

Note that for an 844 device, checkword failures are aai expected 49 

during INIHV label checking. 50 
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1 
Once convinced that It is not destroying files by Mistake* INIHV 2 
proceeds to *r!te a NOS/VE label on the volume. Next It processes the 3 
Utility Hap recorded on the voluiae* The location of the Utility Hap 4 
Is device dependent as is the content of the nap* However the manner 5 
in -which the Utility Hap is r^n6 by the NOS/VE driver is device 6 
Independent as follows? 7 

8 
Th« 644 and 885 Utility Haps are written in small sector for pet by 9 
the factory and by diagnostic utilities* The Utility Haps fall 10 
somewhere within a NOS/VE- HAU (logical sector of 2048 bytes)* The 11 
driver Is given an MAU ordinal by INIHV and the driver attempts to 12 
deliver an HAD* This involves reading either 4 or 5 small sectors 13 
depending upon the device* Because some of the sectors have been 14 
wr I te-protected by the controller and some have not the driver 15 
attempts to read each small sector using the following sequence of 16 
commands* 17 

18 

l«Read protected sector (34) 19 

2. Read (4) 20 

3*Read factory data (30) 21 

4. Read utility map (31) 22 

If m address error Is returned for a particular sector the next read 23 

function is tried for the sane sector until all 4 generic read 24 

functions have been triad or the read is successful* whichever occurs 25 

first* Intervening address error failures are not reported* only the 26 

last of the four* Any failure other than an address error detected 27 

after any of the four generic reads causes request termination and is 28 

reported* 29 

30 

31 

32 

A2.2.1.1 aii.ymii;x-.lii2-££a£sssiiia 33 

34 

35 

36 

The INTIALIZEJ1S_V0LUME subcommand uses the Utility Hap located at 37 

Cylinder 822* Track 0# Sector 2 to flaw defects which have been 38 

detected at the factory or by the CE and recorded In the Utility Map* 39 

40 

The Utility Hap is an array of •» 161 flaw entries* Each entry 41 

documents either a track flaw or a sector flaw* Sector flaws are 42 

recorded in the physical (small) sector numbering scheme* 43 

44 

INIHV logically flaws the DAU affected by a sector flaw and the 3 45 

DAUs affected by a track flaw* Note that because of the data mapping 46 

of the 844 device a track flaw will also logically flaw from to 4 47 

small sectors on the next track* 48 

49 
To support diagnostic use of the device* INIHV also flaws cylinders 50 
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2 

3 

4 

A2.2.1.2 &fi2.U£ili£*-a*&-£tafifiS&lllfl 5 

6 

7 

8 

The INITIALIZERS. VOLUME subcommand uses the Utility Hap located at 9 

Cylinder 841* Track 1* Sector 1 to flaw defects which have been 10 

recorded there by the factory or by a CE» 11 

12 

The Utility Nap is an array of * • 161 flaw entries. Each entry 13 

documents a track flaw. 14 

15 

INIHV logically flaws the 4 DAUs which are affected by a flawed 16 

track. 17 

18 

To support diagnostic use of the device* INIHV flans cylinders 19 

841. .842. 21} 

21 
22 
23 

A2.3 3mma£_a££££I-.ttAtlAS£a£tiI Zh 

25 

26 

A2.3.1 RECOMMENDATIONS FOR 844 AMD 885 DEVICES 27 

28 

29 

30 

Once NOS/VE has been installed and all of Its mass storage volumes 31 

have been initialized* It Is possible that additional defects nil I 32 

appear on the surface of a volume. 33 

34 
The symptom of this defect is likely to initially be a recovered 35 
read/write failure. If the same sector Is reported repeatedly* one 36 
way wish to take action to avoid the loss of performance incurred by 37 
repeated disk driver recovery attempts. The SAVE DATA and RESTORE 38 
DATA capabilities of the FMU diagnostic utility may be used to 39 
relocate the failing sector. This capability only applies to 885 40 
devices as these devices provide two sp^r% sectors per track for this 41 
purpose. The procedure must be performed off-line to NOS/VE* Refer 42 
to the discussion of off-line flawing for further Information* 43 

44 
If the symptom of the defect is an unrecovered read failure* the 45 
recommended procedure is to delete the file to which the failing 46 
sector was allocated. The deletion of the file should only be done 47 
after repeated attempts to read the file have all failed. It is 48 
possible t«<<« 49 

50 
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